Inside Macintosh: QuickTime /

Chapter 3 - Image Compression Manager / Image Compression Manager Reference

Image Compression Manager Functions / Working With Graphics Devices and Graphics Worlds

GetBestDeviceRect

The GetBestDeviceRect function selects the deepest of all available graphics devices, while treating 16-bit and 32-bit screens as having equal depth.

pascal OSErr GetBestDeviceRect (GDHandle *gdh, Rect *rp);

gdh

Contains a pointer to the handle of the rectangle for the chosen device. If you do not need the information in this parameter returned, specify nil.

rp

Contains a pointer to the rectangle that is adjusted for the height of the menu bar if the device is the main device. If you do not need the information in this parameter returned, specify nil.

DESCRIPTION

If multiple 16-bit and 32-bit monitors are available, the GetBestDeviceRect function selects the 16-bit or 32-bit device upon which the cursor has currently been detected. If a cursor is not on one of the devices in question, the first of those in the list is chosen.

Note that the GetBestDeviceRect function does not center a rectangle on a device. Rather, it returns the rectangle for the best device.